home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / cfgsrt13.zip / CFGSORT.TXT < prev    next >
Text File  |  1996-06-24  |  8KB  |  215 lines
  1.  
  2.  
  3.  
  4.                                CONFIGSORT 1.3
  5.  
  6.                        By Philip A. O'Malley (C)1996
  7.  
  8.  
  9. 1.1 INTRODUCTION
  10.  
  11.     The heart of an OS/2 system  is its config.sys file. Unfortunately, this
  12. file starts out as an organizational  mess  and  then gets worse as numerous
  13. applications modify it. Enter ConfigSort.
  14.  
  15.     ConfigSort will take a  config.sys  file  and  convert it into something
  16. substantially more functional.  Additionally,  ConfigSort  also  knows about
  17. multiple entries belonging to certain  applications  and will group any such
  18. entries into sections at the end of the file with a helpful comment.
  19.  
  20.     The difference is quite astounding, as I'm sure you'll agree. :)
  21.  
  22.  
  23. 2.1 REQUIREMENTS
  24.  
  25.     ConfigSort is a REXX program which  has  been compiled using RxCls. As a
  26. consequence you must have REXX installed, which  comes as a standard part of
  27. the OS/2 3.0 distribution.
  28.  
  29.     Additionally, the RXEXTRAS.DLL is also needed as ConfigSort uses some of
  30. the functions contained in that  library.  It  should be placed somehwere in
  31. the LIBPATH. "/OS2/DLL" is usually a good place.
  32.  
  33.  
  34. 2.2 LICENCE FOR USE
  35.  
  36.     ConfigSort is an original program, copyrighted to the author. It may not
  37. be modified in any shape or form.  It can be freely distributed providing no
  38. charge is made beyond those to cover media expenses and the like.
  39.  
  40.     ConfigSort is provided "as  is"  and  any  damage,  actual or perceived,
  41. caused by the program is not the  liability  of  the author. Your use of the
  42. program signifies your acceptance of these conditions.
  43.  
  44.     If you have no problems with the above, then onwards... :)
  45.  
  46.  
  47. 3.1 USAGE AND SYNTAX
  48.  
  49.     ConfigSort is command-line driven. All options are invoked, or prefixed,
  50. by keywords and are:
  51.  
  52.  1. /IN <FQFN>
  53.  
  54.     This specifies the fully-qualified file  name  of the config.sys file to
  55.     be processed. This is the only required keyword.
  56.  
  57.  2. /OUT <FQFN>
  58.  
  59.     This specifies an output file for ConfigSort to write to.
  60.  
  61.     If this keyword is not specified then the original /IN file is backed-up
  62.     with a .bak extension and then overwritten.
  63.  
  64.  3. /NOAPPS
  65.  
  66.     By default, multiple entries made by  an  application are grouped into a
  67.     section at the end of the file. This keyword disables this facility.
  68.  
  69.  4. /NOSORT
  70.  
  71.     By default, all SET statements  are  sorted into descending alphabetical
  72.     order. This keyword disables this facility.
  73.  
  74.  5. /NOUPPER
  75.  
  76.     By default, all lines in the  processed file are turned upper-case, with
  77.     the exeception of the information held  in SET statements.  This keyword
  78.     disables this facility.
  79.  
  80.  
  81. 3.2 EXAMPLES
  82.  
  83.     This section is just intended  to  visualise  the above into something a
  84. little more tangible. Three examples of syntax are shown below:
  85.  
  86.  1. PROCESS "F:\CONFIG.SYS" (AND BACKUP TO F:\CONFIG.BAK)
  87.  
  88.     cfgsort /in f:\config.sys
  89.  
  90.  2. PROCESS "F:\CONFIG.SYS" AND OUTPUT TO "F:\CONFIG.NEW"
  91.  
  92.     cfgsort /in f:\config.sys /out f:\config.new
  93.  
  94.  3. PROCESS "F:\CONFIG.SYS" WITH ALL OPTIONS OFF
  95.  
  96.     cfgsort /in f:\config.sys /noapps /nosort /noupper
  97.  
  98.  
  99. 3.3 KNOWN APPLICATIONS
  100.  
  101.     Currently, ConfigSort knows about the following applications:
  102.  
  103.         1.  EXT2FS
  104.         2   IBM DualStor.
  105.         3.  IBM EWS OS20MEMU
  106.         4   IBM MPTS (basic support).
  107.         5   IBM TCP/IP v2.0 (Bonuspak IAK).
  108.         6   IBM TCP/IP v3.0 (Warp Connect).
  109.         7   IBM WebExplorer 1.1b
  110.         8   PMView
  111.         9   SIO Serial drivers.
  112.        10.  SUBST/2
  113.  
  114.     NB. 2.  The knowlage of Multi-Protocol Transport Services, found in Warp
  115.             Connect, is basic  at  best.  It  comprises  the dial-up support
  116.             drivers for TCP/IP 3.0. As  I  don't  run  a LAN based system, I
  117.             can't include support for this area of MPTS.
  118.  
  119.  
  120. 4.1 VERSION HISTORY
  121.  
  122.     1.3  23/06/96
  123.  
  124.          # Fixed all the internal gremlins with mixed-case.
  125.  
  126.          + Added case-support for  SET  variables.  Now  ConfigSort will NOT
  127.            alter the case of any information assigned to a variable with the
  128.            SET command. This was a much requested revision.
  129.  
  130.          # Fixed a problem when  parsing  filenames without a fully-qualifed
  131.            path. These  are  typically  BASEDEV  entries.  Previously, these
  132.            entries would not get sorted into an application section.
  133.  
  134.          # Fixed the SET statement parsing.  Previously if there was a space
  135.            before or after the '=' sign  the  entry wouldn't get sorted into
  136.            the correct section.
  137.  
  138.          + Added application support for PMVIEW, EXT2FS and OS20MEMU.
  139.  
  140.          + Modified applications support for MPTS and TCP/IP v3.0 to include
  141.            the new entries made by  the  IBM  ServicePaks. I've also removed
  142.            some SET variables and placed them in an IBM related section.
  143.  
  144.     1.21 19/05/96 (Unreleased)
  145.  
  146.          # Fixed a case-sensitivity problem with the /IN command.
  147.  
  148.     1.2  14/05/96
  149.  
  150.          + Added the /NOUPPER option. Previously ConfigSort changed the case
  151.            of the config.sys to uppercase  without option, which could cause
  152.            problems with ANSI sequences for command prompts, etc.
  153.  
  154.          + Added support for the  IBM  WebExplorer  1.1b SET statements into
  155.            the network sections.
  156.  
  157.     1.11 28/04/96
  158.  
  159.          = Added IFCONFIG.EXE to the TCP/IP applications sorting. This was
  160.            an oversight and caused problems for some people.
  161.  
  162.     1.1  16/04/96
  163.  
  164.          - Removed the /SORT option. Previously it shuffled REM'd entries to
  165.            the bottom of a configuration  section,  but as some drivers have
  166.            to be loaded in a correct  order,  for example the sound drivers,
  167.            unREMing those lines later caused  problems  if the correct order
  168.            couldn't be remembered. Thus,  I  decided  that  it could be more
  169.            trouble than it was worth, so it's now gone...
  170.  
  171.          + SET statements are now sorted into descending alphabetical order.
  172.  
  173.          + Added the /NOSORT  option.  This  stops  all  SET statements from
  174.            being sorted.
  175.  
  176.          - An oversight in the  docs  saying  that  the RXEXTRAS.DLL came as
  177.            part of the  OS/2  distribution.  Apologies  to  those  who, as a
  178.            result, couldn't get the program to actually run. :(
  179.  
  180.          - A bug was introduced into 1.0 at the last moment due to brainfade
  181.            on my part and no subsequent testing. Basically ConfigSort didn't
  182.            strip out it's own REM statements which caused them to accumulate
  183.            when a saved file was reprocessed. Minor but annoying.
  184.  
  185.     1.0  05/04/96
  186.  
  187.            First public release.
  188.  
  189.  
  190. 5.1 AFTERWORD
  191.  
  192.     ConfigSort was written as nothing  else satisfied my requirements. Since
  193. the initial release I've had quite a bit of very positive feedback about the
  194. program. I would like to thank all  those  people who reported bugs and gave
  195. me ideas for for future  releases.  I  would  especially  like to thank Gary
  196. Hammer for putting the program on his  WWW site as the program really seemed
  197. to take off after that.
  198.  
  199.  
  200. 5.2 VERSION 1.3
  201.  
  202.     Due to other commitments, ConfigSort v1.3 has been delayed. Apologies to
  203. those who wanted the features released in this version a few weeks back.
  204.  
  205.  
  206. 5.3 CONTACTS
  207.  
  208.     Any suggestions or comments about ConfigSort  would be very welcome. I'm
  209. available for a chat at the following addresses:
  210.  
  211.     internet : phil.omalley@zetnet.co.uk
  212.     fidonet  : "Phil O'Malley" at 2:250/107.96
  213.  
  214. Phil O'Malley, June 23rd 1996.
  215.